Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Movie Spatial Characteristics

GetMovieMatrix

The GetMovieMatrix function allows your application to retrieve a movie's transformation matrix.

pascal void GetMovieMatrix (Movie theMovie, MatrixRecord *matrix);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

matrix

Contains a pointer to a matrix structure. The GetMovieMatrix function returns the movie's matrix into the structure referred to by this parameter.

DESCRIPTION

The Movie Toolbox uses a movie's matrix to map a movie from its coordinate system to the display coordinate system.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

You can set a movie's matrix with the SetMovieMatrix function, which is described in the previous section.

The Movie Toolbox provides a number of functions that allow you to manipulate movie matrices. See "Matrix Functions," which begins on page 2-321, for information about these functions.